<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkEntryCompletion</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="NumericEntry.html" title="数字/文本数据输入项">
<link rel="prev" href="gtk3-GtkEntryBuffer.html" title="GtkEntryBuffer">
<link rel="next" href="gtk3-GtkScale.html" title="GtkScale">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkEntryBuffer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="NumericEntry.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkScale.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkEntryCompletion.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkEntryCompletion.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkEntryCompletion"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkEntryCompletion.top_of_page"></a>GtkEntryCompletion</span></h2>
<p>GtkEntryCompletion — Completion functionality for GtkEntry</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkEntryCompletion.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion">GtkEntryCompletion</a>;
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletionMatchFunc" title="GtkEntryCompletionMatchFunc ()">*GtkEntryCompletionMatchFunc</a>)      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
<a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> * <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-new" title="gtk_entry_completion_new ()">gtk_entry_completion_new</a>           (<em class="parameter"><code><span class="type">void</span></code></em>);
<a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> * <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-new-with-area" title="gtk_entry_completion_new_with_area ()">gtk_entry_completion_new_with_area</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkCellArea.html#GtkCellArea" title="struct GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-entry" title="gtk_entry_completion_get_entry ()">gtk_entry_completion_get_entry</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-model" title="gtk_entry_completion_set_model ()">gtk_entry_completion_set_model</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);
<a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> *      <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-model" title="gtk_entry_completion_get_model ()">gtk_entry_completion_get_model</a>      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-match-func" title="gtk_entry_completion_set_match_func ()">gtk_entry_completion_set_match_func</a> (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletionMatchFunc" title="GtkEntryCompletionMatchFunc ()"><span class="type">GtkEntryCompletionMatchFunc</span></a> func</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> func_notify</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-minimum-key-length" title="gtk_entry_completion_set_minimum_key_length ()">gtk_entry_completion_set_minimum_key_length</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-minimum-key-length" title="gtk_entry_completion_get_minimum_key_length ()">gtk_entry_completion_get_minimum_key_length</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-complete" title="gtk_entry_completion_complete ()">gtk_entry_completion_complete</a>       (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-completion-prefix" title="gtk_entry_completion_get_completion_prefix ()">gtk_entry_completion_get_completion_prefix</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-insert-prefix" title="gtk_entry_completion_insert_prefix ()">gtk_entry_completion_insert_prefix</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-insert-action-text" title="gtk_entry_completion_insert_action_text ()">gtk_entry_completion_insert_action_text</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-insert-action-markup" title="gtk_entry_completion_insert_action_markup ()">gtk_entry_completion_insert_action_markup</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-delete-action" title="gtk_entry_completion_delete_action ()">gtk_entry_completion_delete_action</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-text-column" title="gtk_entry_completion_set_text_column ()">gtk_entry_completion_set_text_column</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-text-column" title="gtk_entry_completion_get_text_column ()">gtk_entry_completion_get_text_column</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-inline-completion" title="gtk_entry_completion_set_inline_completion ()">gtk_entry_completion_set_inline_completion</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> inline_completion</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-inline-completion" title="gtk_entry_completion_get_inline_completion ()">gtk_entry_completion_get_inline_completion</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-inline-selection" title="gtk_entry_completion_set_inline_selection ()">gtk_entry_completion_set_inline_selection</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> inline_selection</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-inline-selection" title="gtk_entry_completion_get_inline_selection ()">gtk_entry_completion_get_inline_selection</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-popup-completion" title="gtk_entry_completion_set_popup_completion ()">gtk_entry_completion_set_popup_completion</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> popup_completion</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-popup-completion" title="gtk_entry_completion_get_popup_completion ()">gtk_entry_completion_get_popup_completion</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-popup-set-width" title="gtk_entry_completion_set_popup_set_width ()">gtk_entry_completion_set_popup_set_width</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> popup_set_width</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-popup-set-width" title="gtk_entry_completion_get_popup_set_width ()">gtk_entry_completion_get_popup_set_width</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-popup-single-match" title="gtk_entry_completion_set_popup_single_match ()">gtk_entry_completion_set_popup_single_match</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> popup_single_match</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-get-popup-single-match" title="gtk_entry_completion_get_popup_single_match ()">gtk_entry_completion_get_popup_single_match</a>
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkEntryCompletion.description"></a><h2>Description</h2>
<p>
<a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> is an auxiliary object to be used in conjunction with
<a class="link" href="gtk3-GtkEntry.html#GtkEntry" title="struct GtkEntry"><span class="type">GtkEntry</span></a> to provide the completion functionality. It implements the
<a class="link" href="gtk3-GtkCellLayout.html#GtkCellLayout" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> interface, to allow the user to add extra cells to the
<a class="link" href="gtk3-GtkTreeView.html#GtkTreeView" title="struct GtkTreeView"><span class="type">GtkTreeView</span></a> with completion matches.
</p>
<p>
"Completion functionality" means that when the user modifies the text
in the entry, <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> checks which rows in the model match
the current content of the entry, and displays a list of matches.
By default, the matching is done by comparing the entry text
case-insensitively against the text column of the model (see
<a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-text-column" title="gtk_entry_completion_set_text_column ()"><code class="function">gtk_entry_completion_set_text_column()</code></a>), but this can be overridden
with a custom match function (see <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-match-func" title="gtk_entry_completion_set_match_func ()"><code class="function">gtk_entry_completion_set_match_func()</code></a>).
</p>
<p>
When the user selects a completion, the content of the entry is
updated. By default, the content of the entry is replaced by the
text column of the model, but this can be overridden by connecting
to the <span class="type">"match-selected"</span> signal and updating the
entry in the signal handler. Note that you should return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from
the signal handler to suppress the default behaviour.
</p>
<p>
To add completion functionality to an entry, use <a class="link" href="gtk3-GtkEntry.html#gtk-entry-set-completion" title="gtk_entry_set_completion ()"><code class="function">gtk_entry_set_completion()</code></a>.
</p>
<p>
In addition to regular completion matches, which will be inserted into the
entry when they are selected, <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> also allows to display
"actions" in the popup window. Their appearance is similar to menuitems,
to differentiate them clearly from completion strings. When an action is
selected, the <span class="type">"action-activated"</span> signal is emitted.
</p>
<p>
GtkEntryCompletion uses a <a class="link" href="gtk3-GtkTreeModelFilter.html#GtkTreeModelFilter" title="struct GtkTreeModelFilter"><span class="type">GtkTreeModelFilter</span></a> model to represent the
subset of the entire model that is currently matching. While the
GtkEntryCompletion signals <span class="type">"match-selected"</span> and
<span class="type">"cursor-on-match"</span> take the original model and an
iter pointing to that model as arguments, other callbacks and signals
(such as <a href="gtk3-GtkCellLayout.html#GtkCellLayoutDataFunc"><span class="type">GtkCellLayoutDataFuncs</span></a> or <span class="type">"apply-attributes"</span>)
will generally take the filter model as argument. As long as you are
only calling <a class="link" href="gtk3-GtkTreeModel.html#gtk-tree-model-get" title="gtk_tree_model_get ()"><code class="function">gtk_tree_model_get()</code></a>, this will make no difference to
you. If for some reason, you need the original model, use
<a class="link" href="gtk3-GtkTreeModelFilter.html#gtk-tree-model-filter-get-model" title="gtk_tree_model_filter_get_model ()"><code class="function">gtk_tree_model_filter_get_model()</code></a>. Don't forget to use
<a class="link" href="gtk3-GtkTreeModelFilter.html#gtk-tree-model-filter-convert-iter-to-child-iter" title="gtk_tree_model_filter_convert_iter_to_child_iter ()"><code class="function">gtk_tree_model_filter_convert_iter_to_child_iter()</code></a> to obtain a
matching iter.
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkEntryCompletion.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkEntryCompletion"></a><h3>struct GtkEntryCompletion</h3>
<pre class="programlisting">struct GtkEntryCompletion {
  GObject parent_instance;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntryCompletionMatchFunc"></a><h3>GtkEntryCompletionMatchFunc ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GtkEntryCompletionMatchFunc)      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>
A function which decides whether the row indicated by <em class="parameter"><code>iter</code></em> matches
a given <em class="parameter"><code>key</code></em>, and should be displayed as a possible completion for <em class="parameter"><code>key</code></em>.
Note that <em class="parameter"><code>key</code></em> is normalized and case-folded (see <a href="../glib/glib-Unicode-Manipulation.html#g-utf8-normalize"><code class="function">g_utf8_normalize()</code></a>
and <a href="../glib/glib-Unicode-Manipulation.html#g-utf8-casefold"><code class="function">g_utf8_casefold()</code></a>). If this is not appropriate, match functions
have access to the unmodified key via
<code class="literal">gtk_entry_get_text (GTK_ENTRY (gtk_entry_completion_get_entry ()))</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>the <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td>the string to match, normalized and case-folded</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> indicating the row to match</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data given to <a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-set-match-func" title="gtk_entry_completion_set_match_func ()"><code class="function">gtk_entry_completion_set_match_func()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>iter</code></em> should be displayed as a possible completion
for <em class="parameter"><code>key</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-new"></a><h3>gtk_entry_completion_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> * gtk_entry_completion_new           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Creates a new <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> object.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A newly created <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> object</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-new-with-area"></a><h3>gtk_entry_completion_new_with_area ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> * gtk_entry_completion_new_with_area (<em class="parameter"><code><a class="link" href="gtk3-GtkCellArea.html#GtkCellArea" title="struct GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre>
<p>
Creates a new <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> object using the
specified <em class="parameter"><code>area</code></em> to layout cells in the underlying
<a class="link" href="gtk3-GtkTreeViewColumn.html#GtkTreeViewColumn" title="struct GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a> for the drop-down menu.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>area</code></em> :</span></p></td>
<td>the <a class="link" href="gtk3-GtkCellArea.html#GtkCellArea" title="struct GtkCellArea"><span class="type">GtkCellArea</span></a> used to layout cells</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A newly created <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> object</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-entry"></a><h3>gtk_entry_completion_get_entry ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_entry_completion_get_entry      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Gets the entry <em class="parameter"><code>completion</code></em> has been attached to.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The entry <em class="parameter"><code>completion</code></em> has been attached to. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-model"></a><h3>gtk_entry_completion_set_model ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_model      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
<p>
Sets the model for a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>. If <em class="parameter"><code>completion</code></em> already has
a model set, it will remove it before setting the new model.
If model is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then it will unset the model.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>model</code></em> :</span></p></td>
<td>the <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-model"></a><h3>gtk_entry_completion_get_model ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> *      gtk_entry_completion_get_model      (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns the model the <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> is using as data source.
Returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the model is unset.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none
is currently being used. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-match-func"></a><h3>gtk_entry_completion_set_match_func ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_match_func (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletionMatchFunc" title="GtkEntryCompletionMatchFunc ()"><span class="type">GtkEntryCompletionMatchFunc</span></a> func</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> func_notify</code></em>);</pre>
<p>
Sets the match function for <em class="parameter"><code>completion</code></em> to be <em class="parameter"><code>func</code></em>. The match function
is used to determine if a row should or should not be in the completion
list.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
<td>the <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletionMatchFunc" title="GtkEntryCompletionMatchFunc ()"><span class="type">GtkEntryCompletionMatchFunc</span></a> to use</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func_data</code></em> :</span></p></td>
<td>user data for <em class="parameter"><code>func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func_notify</code></em> :</span></p></td>
<td>destroy notify for <em class="parameter"><code>func_data</code></em>.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-minimum-key-length"></a><h3>gtk_entry_completion_set_minimum_key_length ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_minimum_key_length
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>);</pre>
<p>
Requires the length of the search key for <em class="parameter"><code>completion</code></em> to be at least
<em class="parameter"><code>length</code></em>. This is useful for long lists, where completing using a small
key takes a lot of time and will come up with meaningless results anyway
(ie, a too large dataset).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>the minimum length of the key in order to start completing</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-minimum-key-length"></a><h3>gtk_entry_completion_get_minimum_key_length ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_entry_completion_get_minimum_key_length
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns the minimum key length as set for <em class="parameter"><code>completion</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The currently used minimum key length</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-complete"></a><h3>gtk_entry_completion_complete ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_complete       (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Requests a completion operation, or in other words a refiltering of the
current list with completions, using the current key. The completion list
view will be updated accordingly.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-completion-prefix"></a><h3>gtk_entry_completion_get_completion_prefix ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_entry_completion_get_completion_prefix
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Get the original text entered by the user that triggered
the completion or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there's no completion ongoing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the prefix for the current completion</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-insert-prefix"></a><h3>gtk_entry_completion_insert_prefix ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_insert_prefix  (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Requests a prefix insertion.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-insert-action-text"></a><h3>gtk_entry_completion_insert_action_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_insert_action_text
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
<p>
Inserts an action in <em class="parameter"><code>completion</code></em>'s action item list at position <em class="parameter"><code>index_</code></em>
with text <em class="parameter"><code>text</code></em>. If you want the action item to have markup, use
<a class="link" href="gtk3-GtkEntryCompletion.html#gtk-entry-completion-insert-action-markup" title="gtk_entry_completion_insert_action_markup ()"><code class="function">gtk_entry_completion_insert_action_markup()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
<td>the index of the item to insert</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>text of the item to insert</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-insert-action-markup"></a><h3>gtk_entry_completion_insert_action_markup ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_insert_action_markup
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);</pre>
<p>
Inserts an action in <em class="parameter"><code>completion</code></em>'s action item list at position <em class="parameter"><code>index_</code></em>
with markup <em class="parameter"><code>markup</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
<td>the index of the item to insert</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>markup</code></em> :</span></p></td>
<td>markup of the item to insert</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-delete-action"></a><h3>gtk_entry_completion_delete_action ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_delete_action  (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);</pre>
<p>
Deletes the action at <em class="parameter"><code>index_</code></em> from <em class="parameter"><code>completion</code></em>'s action list.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
<td>the index of the item to delete</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-text-column"></a><h3>gtk_entry_completion_set_text_column ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_text_column
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
<p>
Convenience function for setting up the most used case of this code: a
completion list with just strings. This function will set up <em class="parameter"><code>completion</code></em>
to have a list displaying all (and just) strings in the completion list,
and to get those strings from <em class="parameter"><code>column</code></em> in the model of <em class="parameter"><code>completion</code></em>.
</p>
<p>
This functions creates and adds a <a class="link" href="gtk3-GtkCellRendererText.html#GtkCellRendererText" title="struct GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> for the selected
column. If you need to set the text column, but don't want the cell
renderer, use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-set"><code class="function">g_object_set()</code></a> to set the <span class="type">"text-column"</span>
property directly.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>column</code></em> :</span></p></td>
<td>the column in the model of <em class="parameter"><code>completion</code></em> to get strings from</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-text-column"></a><h3>gtk_entry_completion_get_text_column ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_entry_completion_get_text_column
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns the column in the model of <em class="parameter"><code>completion</code></em> to get strings from.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the column containing the strings</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-inline-completion"></a><h3>gtk_entry_completion_set_inline_completion ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_inline_completion
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> inline_completion</code></em>);</pre>
<p>
Sets whether the common prefix of the possible completions should
be automatically inserted in the entry.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>inline_completion</code></em> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to do inline completion</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-inline-completion"></a><h3>gtk_entry_completion_get_inline_completion ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_entry_completion_get_inline_completion
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns whether the common prefix of the possible completions should
be automatically inserted in the entry.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if inline completion is turned on</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-inline-selection"></a><h3>gtk_entry_completion_set_inline_selection ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_inline_selection
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> inline_selection</code></em>);</pre>
<p>
Sets whether it is possible to cycle through the possible completions
inside the entry.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>inline_selection</code></em> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to do inline selection</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-inline-selection"></a><h3>gtk_entry_completion_get_inline_selection ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_entry_completion_get_inline_selection
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if inline-selection mode is turned on.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if inline-selection mode is on</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-popup-completion"></a><h3>gtk_entry_completion_set_popup_completion ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_popup_completion
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> popup_completion</code></em>);</pre>
<p>
Sets whether the completions should be presented in a popup window.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>popup_completion</code></em> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to do popup completion</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-popup-completion"></a><h3>gtk_entry_completion_get_popup_completion ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_entry_completion_get_popup_completion
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns whether the completions should be presented in a popup window.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if popup completion is turned on</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-popup-set-width"></a><h3>gtk_entry_completion_set_popup_set_width ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_popup_set_width
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> popup_set_width</code></em>);</pre>
<p>
Sets whether the completion popup window will be resized to be the same
width as the entry.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>popup_set_width</code></em> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to make the width of the popup the same as the entry</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-popup-set-width"></a><h3>gtk_entry_completion_get_popup_set_width ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_entry_completion_get_popup_set_width
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns whether the  completion popup window will be resized to the
width of the entry.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the popup window will be resized to the width of
the entry</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-set-popup-single-match"></a><h3>gtk_entry_completion_set_popup_single_match ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_entry_completion_set_popup_single_match
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> popup_single_match</code></em>);</pre>
<p>
Sets whether the completion popup window will appear even if there is
only a single match. You may want to set this to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if you
are using <GTKDOCLINK HREF="GtkEntryCompletion--inline-completion">inline
completion</GTKDOCLINK>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>popup_single_match</code></em> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the popup should appear even for a single
match</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-completion-get-popup-single-match"></a><h3>gtk_entry_completion_get_popup_single_match ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_entry_completion_get_popup_single_match
                                                        (<em class="parameter"><code><a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>
Returns whether the completion popup window will appear even if there is
only a single match.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>completion</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkEntryCompletion.html#GtkEntryCompletion" title="struct GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the popup window will appear regardless of the
number of matches</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>